az ml model
Note
このリファレンスは、Azure CLI (バージョン 2.0.28 以降) の azure-cli-ml 拡張機能の一部です。 拡張機能は、 az ml model コマンドを初めて実行するときに自動的にインストールされます。 拡張機能の詳細をご覧ください。
機械学習モデルを管理します。
コマンド
名前 | 説明 | 型 | Status |
---|---|---|---|
az ml model delete |
ワークスペースからモデルを削除します。 |
拡張子 | GA |
az ml model deploy |
ワークスペースからモデルをデプロイします。 |
拡張子 | GA |
az ml model download |
ワークスペースからモデルをダウンロードします。 |
拡張子 | GA |
az ml model list |
ワークスペース内のモデルを一覧表示します。 |
拡張子 | GA |
az ml model package |
ワークスペースにモデルをパッケージ化します。 |
拡張子 | GA |
az ml model profile |
ワークスペース内のプロファイル モデル。 |
拡張子 | GA |
az ml model register |
モデルをワークスペースに登録します。 |
拡張子 | GA |
az ml model show |
ワークスペースにモデルを表示します。 |
拡張子 | GA |
az ml model update |
ワークスペース内のモデルを更新します。 |
拡張子 | GA |
az ml model delete
ワークスペースからモデルを削除します。
az ml model delete --model-id
[--path]
[--resource-group]
[--subscription-id]
[--workspace-name]
[-v]
必須のパラメーター
削除するモデルの ID。
省略可能のパラメーター
プロジェクト フォルダーへのパス。 既定値: 現在のディレクトリ。
指定されたワークスペースに対応するリソース グループ。
サブスクリプション ID を指定します。
ワークスペースの名前です。
詳細度フラグ。
グローバル パラメーター
すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告は抑制します。
出力形式。
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID
を使用して、既定のサブスクリプションを構成できます。
ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。
az ml model deploy
ワークスペースからモデルをデプロイします。
az ml model deploy --name
[--ae]
[--ai]
[--ar]
[--as]
[--at]
[--autoscale-max-replicas]
[--autoscale-min-replicas]
[--base-image]
[--base-image-registry]
[--cc]
[--ccl]
[--cf]
[--collect-model-data]
[--compute-target]
[--compute-type]
[--cuda-version]
[--dc]
[--description]
[--dn]
[--ds]
[--ed]
[--eg]
[--entry-script]
[--environment-name]
[--environment-version]
[--failure-threshold]
[--gb]
[--gbl]
[--gc]
[--ic]
[--id]
[--key-name]
[--key-version]
[--kp]
[--ks]
[--lo]
[--max-request-wait-time]
[--model]
[--model-metadata-file]
[--namespace]
[--no-wait]
[--nr]
[--overwrite]
[--path]
[--period-seconds]
[--pi]
[--po]
[--property]
[--replica-max-concurrent-requests]
[--resource-group]
[--rt]
[--sc]
[--scoring-timeout-ms]
[--sd]
[--se]
[--sk]
[--sp]
[--st]
[--subnet-name]
[--subscription-id]
[--tag]
[--timeout-seconds]
[--token-auth-enabled]
[--tp]
[--vault-base-url]
[--version-name]
[--vnet-name]
[--workspace-name]
[-v]
必須のパラメーター
デプロイされたサービスの名前。
省略可能のパラメーター
この Webservice に対してキー認証を有効にするかどうかを指定します。 既定値は False です。
この Web サービスに対して AppInsights を有効にするかどうか。 既定値は False です。
自動スケーラーがこの Webservice のスケーリングを試行する頻度。 デフォルト値は 1 です。
この Web サービスに対して自動スケーリングを有効にするかどうか。 num_replicas が None の場合、既定値は True です。
自動スケーラーがこの Webservice に対して維持しようとする目標使用率 (最大 100%)。 既定値は 70 です。
この Webservice を自動スケーリングするときに使用するコンテナーの最大数。 既定値は 10 です。
この Webservice を自動スケーリングするときに使用するコンテナーの最小数。 デフォルト値は 1 です。
基本イメージとして使用するカスタム イメージ。 基本イメージが指定されていない場合、指定されたランタイム パラメーターに基づいた基本イメージが使用されます。
基本イメージを含むイメージ レジストリ。
この Web サービスに割り当てる CPU コアの数。 10 進数を指定できます。 既定値は 0.1 です。
この Webservice で使用できる CPU コアの最大数。 10 進数を指定できます。
イメージに使用する Conda 環境定義を含むローカル ファイルのパス。
この Web サービスに対してモデル データ収集を有効にするかどうか。 既定値は False です。
コンピューティング 先の名前。 AKS にデプロイする場合にのみ適用されます。
デプロイするサービスのコンピューティングの種類。
GPU のサポートが必要なイメージにインストールする CUDA のバージョン。 GPU イメージは、Azure Container Instances、Azure Machine Learning コンピューティング、Azure Virtual Machines、Azure Kubernetes Service などの Microsoft Azure サービス上で使用する必要があります。 サポートされているバージョンは 9.0、9.1、10.0 です。 "enable_gpu" が設定されている場合、これの既定値は "9.1" です。
デプロイ メタデータを含む JSON または YAML ファイルへのパス。
デプロイされたサービスの説明。
この Web サービスの DNS 名。
イメージを設定するときに実行する追加の Docker 手順を含むローカル ファイルのパス。
デプロイ用の Azure Machine Learning Environment のディレクトリ。 これは、'az ml environment scaffold' コマンドで指定されたのと同じディレクトリ パスです。
イメージで GPU サポートを有効にするかどうか。 GPU イメージは、Azure Container Instances、Azure Machine Learning コンピューティング、Azure Virtual Machines、Azure Kubernetes Service などの Microsoft Azure サービス上で使用する必要があります。 既定値は False です。
サービス用に実行するコードを含むローカル ファイルへのパス (指定されている場合はsource_directoryからの相対パス)。
デプロイ用の Azure Machine Learning 環境の名前。
デプロイ用の既存の Azure Machine Learning 環境のバージョン。
ポッドが起動し、ライブネス プローブが失敗した場合、Kubernetes は --failure-threshold 時間を試してから終了します。 既定値は 3 です。 最大値は 1 です。
この Web サービスに割り当てるメモリの量 (GB 単位)。 10 進数を指定できます。
この Web サービスで使用できるメモリの最大量 (GB 単位)。 10 進数を指定できます。
この Web サービスに割り当てる GPU コアの数。 既定値は 1 です。
推論構成を含む JSON または YAML ファイルへのパス。
コンテナーの起動後、liveness probe が開始するまでの秒数。 既定値は 310 です。
ACI のカスタマー マネージド キー (CMK) の暗号化プロパティのキー名。
ACI のカスタマー マネージド キー (CMK) の暗号化プロパティのキー バージョン。
この Web サービスに使用するプライマリ認証キー。
この Web サービスに使用するセカンダリ認証キー。
この Web サービスのデプロイ先となる Azure リージョン。 指定されていない場合、ワークスペースの場所が使用されます。 利用可能なリージョンの詳細については、 https://azure.microsoft.com/en-us/global-infrastructure/services/?regions=all&を参照してください。products=container-instances。
503 エラーを返すまでに、要求がキューに置かれる最大時間 (ミリ秒単位)。 既定値は 500 です。
デプロイするモデルの ID。 複数のモデルを追加の -m 引数で指定できます。 最初にモデルを登録する必要があります。
モデル登録メタデータを含む JSON ファイルへのパス。 複数の -f パラメーターを使用して、複数のモデルを指定できます。
サービスをデプロイする Kubernetes 名前空間: 最大 63 文字の小文字 ('-'z'、'0'-'9')、ハイフン ('-') 文字。 先頭と末尾の文字をハイフンにすることはできません。 AKS にデプロイする場合にのみ適用されます。
非同期呼び出しを待機しないフラグ。
この Webservice に割り当てるコンテナーの数。 既定値はありません。このパラメーターが設定されない場合、自動スケーラーは既定で有効になります。
名前が競合する場合は、既存のサービスを上書きします。
プロジェクト フォルダーへのパス。 既定値: 現在のディレクトリ。
liveness probe を実行する頻度 (秒単位)。 既定値は 10 秒です。 最大値は 1 です。
プロファイリング結果を含む JSON ファイルへのパス。
サービスの HTTP エンドポイントを公開するローカル ポート。
追加するキー/値プロパティ (e.g. key=value)。 複数のプロパティは、複数の --property オプションで指定できます。
この Web サービスに対して許可するノードあたりの最大同時要求数。 デフォルト値は 1 です。
指定されたワークスペースに対応するリソース グループ。
イメージに使用するランタイム。 現在サポートされているランタイムは、'spark-py' と 'python'spark-py|python|python-slim です。
SSL が有効な場合の cname
この Web サービスに対するスコアリング呼び出しに適用するタイムアウト。 既定値は 60000 です。
イメージを作成するためのファイルをすべて含むフォルダーのパス。
この Web サービスに対して SSL を有効にするかどうか。 既定値は False です。
SSL が有効な場合、キー ファイルが必要です。
SSL が有効な場合、証明書ファイルが必要です。
失敗後、liveness probe が成功と見なされるための最小連続成功数。 既定値は 1 です。 最大値は 1 です。
VNet 内のサブネットの名前。
サブスクリプション ID を指定します。
追加するキー/値タグ (e.g. key=value)。 複数のタグを複数の --tag オプションで指定できます。
liveness probe がタイムアウトするまでの秒数。既定値は 2 秒です。 最大値は 1 です。
この Web サービスのトークン認証を有効にするかどうかを指定します。 AKS にデプロイしない場合は無視されます。 既定値は False です。
バージョンがエンドポイントで受け取るトラフィックの量。 10 進数を指定できます。 既定値は 0 です。
ACI のカスタマー マネージド キー (CMK) の暗号化プロパティのコンテナー ベース URL。
エンドポイントのバージョン名。 既定では、最初のバージョンのエンドポイント名が使用されます。
仮想ネットワークの名前。
ワークスペースの名前です。
詳細度フラグ。
グローバル パラメーター
すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告は抑制します。
出力形式。
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID
を使用して、既定のサブスクリプションを構成できます。
ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。
az ml model download
ワークスペースからモデルをダウンロードします。
az ml model download --model-id
--target-dir
[--overwrite]
[--path]
[--resource-group]
[--subscription-id]
[--workspace-name]
[-v]
必須のパラメーター
モデルの ID。
モデル ファイルをダウンロードするターゲット ディレクトリ。
省略可能のパラメーター
ターゲット ディレクトリに同じ名前ファイルが存在する場合は上書きします。
プロジェクト フォルダーへのパス。 既定値: 現在のディレクトリ。
指定されたワークスペースに対応するリソース グループ。
サブスクリプション ID を指定します。
表示するモデルを含むワークスペースの名前。
詳細度フラグ。
グローバル パラメーター
すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告は抑制します。
出力形式。
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID
を使用して、既定のサブスクリプションを構成できます。
ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。
az ml model list
ワークスペース内のモデルを一覧表示します。
az ml model list [--dataset-id]
[--latest]
[--model-name]
[--path]
[--property]
[--resource-group]
[--run-id]
[--subscription-id]
[--tag]
[--workspace-name]
[-v]
省略可能のパラメーター
指定した場合、指定されたデータセット ID を持つモデルのみが表示されます。
指定した場合、最新バージョンのモデルのみが返されます。
リストをフィルター処理する省略可能なモデル名。
プロジェクト フォルダーへのパス。 既定値: 現在のディレクトリ。
追加するキー/値プロパティ (e.g. key=value)。 複数のプロパティは、複数の --property オプションで指定できます。
指定されたワークスペースに対応するリソース グループ。
指定した場合、指定された実行 ID を持つモデルのみが表示されます。
サブスクリプション ID を指定します。
追加するキー/値タグ (e.g. key=value)。 複数のタグを複数の --tag オプションで指定できます。
一覧表示するモデルを含むワークスペースの名前。
詳細度フラグ。
グローバル パラメーター
すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告は抑制します。
出力形式。
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID
を使用して、既定のサブスクリプションを構成できます。
ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。
az ml model package
ワークスペースにモデルをパッケージ化します。
az ml model package [--cf]
[--ed]
[--entry-script]
[--environment-name]
[--environment-version]
[--ic]
[--il]
[--image-name]
[--model]
[--model-metadata-file]
[--no-wait]
[--output-path]
[--path]
[--resource-group]
[--rt]
[--sd]
[--subscription-id]
[--workspace-name]
[-v]
省略可能のパラメーター
パッケージに使用する conda 環境定義を含むローカル ファイルへのパス。
パッケージ化のための Azure Machine Learning Environment のディレクトリ。 これは、'az ml environment scaffold' コマンドで指定されたのと同じディレクトリ パスです。
サービス用に実行するコードを含むローカル ファイルへのパス (指定されている場合はsource_directoryからの相対パス)。
パッケージ化のための Azure Machine Learning Environment の名前。
パッケージ化のための既存の Azure Machine Learning 環境のバージョン。
推論構成を含む JSON または YAML ファイルへのパス。
ビルドされたパッケージ イメージを提供するラベル。
ビルドされたパッケージ イメージを指定する名前。
パッケージ化するモデルの ID。 複数のモデルを追加の -m 引数で指定できます。 最初にモデルを登録する必要があります。
モデル登録メタデータを含む JSON ファイルへのパス。 複数の -f パラメーターを使用して、複数のモデルを指定できます。
非同期呼び出しを待機しないフラグ。
Docker コンテキストの出力パス。 出力パスが渡されると、ワークスペース ACR でイメージをビルドする代わりに、dockerfile と必要なビルド コンテキストがそのパスに書き込まれます。
プロジェクト フォルダーへのパス。 既定値: 現在のディレクトリ。
指定されたワークスペースに対応するリソース グループ。
パッケージに使用するランタイム。 現在サポートされているランタイムは、'spark-py' と 'python'spark-py|python|python-slim です。
イメージを作成するためのファイルをすべて含むフォルダーのパス。
サブスクリプション ID を指定します。
ワークスペースの名前です。
詳細度フラグ。
グローバル パラメーター
すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告は抑制します。
出力形式。
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID
を使用して、既定のサブスクリプションを構成できます。
ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。
az ml model profile
ワークスペース内のプロファイル モデル。
az ml model profile --name
[--base-image]
[--base-image-registry]
[--cc]
[--cf]
[--description]
[--ed]
[--entry-script]
[--environment-name]
[--environment-version]
[--gb]
[--ic]
[--idi]
[--model]
[--model-metadata-file]
[--output-metadata-file]
[--resource-group]
[--sd]
[--subscription-id]
[--workspace-name]
[-v]
必須のパラメーター
モデル プロファイルの名前。
省略可能のパラメーター
基本イメージとして使用するカスタム イメージ。 基本イメージが指定されていない場合、指定されたランタイム パラメーターに基づいた基本イメージが使用されます。
基本イメージを含むイメージ レジストリ。
プロファイリング時に使用する最大 CPU の倍精度浮動小数点値。
イメージに使用する Conda 環境定義を含むローカル ファイルのパス。
モデル プロファイルの説明。
デプロイ用の Azure Machine Learning Environment のディレクトリ。 これは、'az ml environment scaffold' コマンドで指定されたのと同じディレクトリ パスです。
サービス用に実行するコードを含むローカル ファイルへのパス (指定されている場合はsource_directoryからの相対パス)。
デプロイ用の Azure Machine Learning 環境の名前。
デプロイ用の既存の Azure Machine Learning 環境のバージョン。
プロファイリング時に使用する最大メモリの 2 倍の値。
推論構成を含む JSON または YAML ファイルへのパス。
プロファイルの入力として使用する表形式データセットの ID。
デプロイするモデルの ID。 複数のモデルを追加の -m 引数で指定できます。 最初にモデルを登録する必要があります。
モデル登録メタデータを含む JSON ファイルへのパス。 複数の -f パラメーターを使用して、複数のモデルを指定できます。
プロファイルの結果メタデータが書き込まれる JSON ファイルへのパス。 モデルのデプロイの入力として使用されます。
指定されたワークスペースに対応するリソース グループ。
イメージを作成するためのファイルをすべて含むフォルダーのパス。
サブスクリプション ID を指定します。
ワークスペースの名前です。
詳細度フラグ。
グローバル パラメーター
すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告は抑制します。
出力形式。
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID
を使用して、既定のサブスクリプションを構成できます。
ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。
az ml model register
モデルをワークスペースに登録します。
az ml model register --name
[--asset-path]
[--cc]
[--description]
[--experiment-name]
[--gb]
[--gc]
[--model-framework]
[--model-framework-version]
[--model-path]
[--output-metadata-file]
[--path]
[--property]
[--resource-group]
[--run-id]
[--run-metadata-file]
[--sample-input-dataset-id]
[--sample-output-dataset-id]
[--subscription-id]
[--tag]
[--workspace-name]
[-v]
必須のパラメーター
登録するモデルの名前。
省略可能のパラメーター
experiement が実行されるクラウド パスには、モデル ファイルが格納されます。
このモデルに割り当てる CPU コアの既定の数。 10 進数を指定できます。
モデルの説明。
実験の名前。
このモデルに割り当てるメモリの既定の量 (GB 単位)。 10 進数を指定できます。
このモデルに割り当てる GPU の既定の数。
登録するモデルのフレームワーク。 現在サポートされているフレームワーク: TensorFlow、ScikitLearn、Onnx、Custom、Multi。
登録するモデルのフレームワーク バージョン (例: 1.0.0、2.4.1)。
登録するモデル ファイルの完全パス。
モデル登録メタデータが書き込まれる JSON ファイルへのパス。 モデルのデプロイの入力として使用されます。
プロジェクト フォルダーへのパス。 既定値: 現在のディレクトリ。
追加するキー/値プロパティ (e.g. key=value)。 複数のプロパティは、複数の --property オプションで指定できます。
指定されたワークスペースに対応するリソース グループ。
モデルが登録される実験実行の ID。
experiement 実行メタデータを含む JSON ファイルへのパス。
サンプル入力データセットの ID。
サンプル出力データセットの ID。
サブスクリプション ID を指定します。
追加するキー/値タグ (e.g. key=value)。 複数のタグを複数の --tag オプションで指定できます。
このモデルを登録するワークスペースの名前。
詳細度フラグ。
グローバル パラメーター
すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告は抑制します。
出力形式。
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID
を使用して、既定のサブスクリプションを構成できます。
ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。
az ml model show
ワークスペースにモデルを表示します。
az ml model show [--model-id]
[--model-name]
[--path]
[--resource-group]
[--run-id]
[--subscription-id]
[--version]
[--workspace-name]
[-v]
省略可能のパラメーター
表示するモデルの ID。
表示するモデルの名前。
プロジェクト フォルダーへのパス。 既定値: 現在のディレクトリ。
指定されたワークスペースに対応するリソース グループ。
指定した場合、指定された実行 ID を持つモデルのみが表示されます。
サブスクリプション ID を指定します。
指定した場合、指定した名前とバージョンのモデルのみが表示されます。
表示するモデルを含むワークスペースの名前。
詳細度フラグ。
グローバル パラメーター
すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告は抑制します。
出力形式。
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID
を使用して、既定のサブスクリプションを構成できます。
ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。
az ml model update
ワークスペース内のモデルを更新します。
az ml model update --model-id
[--add-property]
[--add-tag]
[--cc]
[--description]
[--gb]
[--gc]
[--path]
[--remove-tag]
[--resource-group]
[--sample-input-dataset-id]
[--sample-output-dataset-id]
[--subscription-id]
[--workspace-name]
[-v]
必須のパラメーター
モデルの ID。
省略可能のパラメーター
追加するキー/値プロパティ (e.g. key=value)。 複数の --add-property オプションを使用して、複数のプロパティを指定できます。
追加するキー/値タグ (e.g. key=value)。 複数の --add-tag オプションを使用して、複数のタグを指定できます。
このモデルに割り当てる CPU コアの既定の数。 10 進数を指定できます。
モデルの更新に使用する説明。 現在の説明を置き換えます。
このモデルに割り当てるメモリの既定の量 (GB 単位)。 10 進数を指定できます。
このモデルに割り当てる GPU の既定の数。
プロジェクト フォルダーへのパス。 既定値: 現在のディレクトリ。
削除するタグのキー。 複数のタグを複数の --remove-tag オプションで指定できます。
指定されたワークスペースに対応するリソース グループ。
サンプル入力データセットの ID。
サンプル出力データセットの ID。
サブスクリプション ID を指定します。
ワークスペースの名前です。
詳細度フラグ。
グローバル パラメーター
すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告は抑制します。
出力形式。
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID
を使用して、既定のサブスクリプションを構成できます。
ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。
Azure CLI